home *** CD-ROM | disk | FTP | other *** search
/ World of Video / World of Video.iso / programs / print / columns / columns.doc < prev    next >
Encoding:
Text File  |  1995-02-13  |  11.7 KB  |  307 lines
  1.  
  2.  **************************************************************************** 
  3. ******************************************************************************
  4. **                                                                          **
  5. **                               Columns 2.6                                **
  6. **                                                                          **
  7. **                         The Paper Saving Utility                         **
  8. **                                                                          **
  9. **                                                                          **
  10. **                     (c) 1993 MJSoft System Software                      **
  11. **                                                                          **
  12. **                                    -                                     **
  13. **                                                                          **
  14. **                              Martin  Mares                               **
  15. **                                                                          **
  16. **                                   and                                    **
  17. **                                                                          **
  18. **                              Tomas Zikmund                               **
  19. **                                                                          **
  20. ******************************************************************************
  21.  **************************************************************************** 
  22.  
  23.  
  24.    CONTENTS:
  25.    ---------
  26.  
  27.   1. Preview
  28.   2. System requirements
  29.   3. How to start Columns
  30.   4. The main window
  31.   5. Action gadgets
  32.   6. String gadgets
  33.   7. Option gadgets
  34.   8. Remarks
  35.  
  36.  
  37. 1. Preview
  38. ----------
  39.  
  40.    This utility allows you to control your printer in the more efficient way -
  41. you can print the text in columns and use various compression modes (up to 160
  42. characters  per  line  and  180 lines per standard DIN A4 page - cca 5.6 times
  43. more characters than in usual modes, but still readable...).
  44.  
  45.    Main features:
  46.  
  47.      - Written completely in assembly
  48.  
  49.      - Kickstart 2.0 and 3.0 compatible
  50.  
  51.      - Kickstart 2.0 look
  52.  
  53.      - Keyboard controls
  54.  
  55.      - Saveable settings
  56.  
  57.  
  58.    COLUMNS and its documentation is Copyright (c) Martin Mares & Tomas
  59. Zikmund, MJSoft System Software, Prague, Czech Republic.
  60.  
  61.    This  archive  can be freely redistributed, as long as all of its files are
  62. included   in   their  original  form  without  any  additions,  deletions  or
  63. modifications, and no more than a nominal fee is charged for its distribution.
  64. All  copyright  notices  in  the programs and accompanying documentation files
  65. must  remain  on  their places.  Also '.displayme' and other similar files may
  66. not be added.  This is generally known as FREEWARE.
  67.  
  68.    Special  permission is given to Fred Fish to distribute this program on his
  69. "Fish Disks".
  70.  
  71.    This  software  is  provided  "AS IS" without warranty of any kind,  either
  72. expressed  or implied.  The author is not responsible for any damage caused by
  73. it.
  74.  
  75.  
  76. 2. System requirements
  77. ----------------------
  78.  
  79.    This program requires:
  80.  
  81.       - Kickstart 1.2 or higher
  82.  
  83.       - Arp.library
  84.  
  85.       - Req.library or reqtools.library (if both are available, reqtools will
  86.         be used)
  87.  
  88.  
  89. 3. How to start Columns
  90. -----------------------
  91.  
  92.    There are two ways to start Columns and pass it the parameters:
  93.  
  94.       - Start it from CLI
  95.  
  96.           - Parameter template: PRINT/S,FROM,TO,CFG/K
  97.  
  98.                - PRINT: start operation automatically without entering GUI.
  99.                         In this case, only the status window will appear
  100.                         and all error messages will be written to standard
  101.                         output.
  102.  
  103.                - FROM:  name of source file you want to process
  104.  
  105.                - TO:    name of destination file to store the result to
  106.  
  107.                - CFG:   name of configuration file to be used
  108.  
  109.             - You can start Columns in batch mode (the PRINT option) or only
  110.               fill in the filename gadgets.
  111.  
  112.             - You can use '?' for help, then '?' for more help (as in ARP
  113.               commands).
  114.  
  115.       - Start it from Workbench
  116.  
  117.             - you can start it simply by doubleclicking its icon.
  118.  
  119.             - you can specify input/output/configuration file name as the tool
  120.               types (FROM=,TO= and CFG=) - consult your Workbench manual how
  121.               to do it.
  122.  
  123.             - you can shift-doubleclick the source file you wish to use.
  124.  
  125.             - the source file passed by shift-doubleclick can also have tool
  126.               types, which will be used instead of the standard tool types.
  127.  
  128.             - it's also possible to set the default tool of some project to
  129.               Columns. This file will be used as the source file and its tool
  130.               types will be used.
  131.  
  132.  
  133. 4. The main window
  134. ------------------
  135.  
  136.    If  you  start  Columns, the main window will appear.  You can see a lot of
  137. gadgets and texts on it.  Let's explain them:
  138.  
  139.    In  the  top  left  corner of the window you can see three large boxes with
  140. small  gadgets named "FROM", "TO" and "CTAB" on the left.  These boxes display
  141. the  file  names  -  name of the source file, name of the destination file and
  142. name  of  the  conversion  table  file.   You  can select the file by the file
  143. requester if you click on the corresponding gadget.
  144.  
  145.    There are some relatively large gadgets in the top right corner.  There are
  146. named  "action  gadgets".   Each  of  these gadgets starts some process (other
  147. gadgets control only the parameters of the process).
  148.  
  149.    The  rest of the screen consists of the left half containing string gadgets
  150. with  many  settings (as the page width, page heights, tab size and so on) and
  151. the right half filled with switches.
  152.  
  153.  
  154. 5. Action gadgets
  155. -----------------
  156.  
  157.    CONVERT  -  start  text  processing from the input file to the output file.
  158. The  status  window  will be opened and will show status of the operation (see
  159. below).
  160.  
  161.    PRINT - start text processing from the input file to the printer.
  162.  
  163.    INFO  -  start  text  processing  from  the  input file without any output.
  164. Useful for determining the number of pages and similar parameters.
  165.  
  166.    SAVE  CONFIG  -  save  configuration.   The  default  configuration file is
  167. s:columns.def.   You  can  save the defaults into the current directory - they
  168. will  have  higher  priority.  It's also possible to save the defaults to some
  169. other  file and load it using the CFG option (or the CFG tool type).  The file
  170. requester will show you the name of the currently used default file.
  171.  
  172.    STD  SIZE - recalculate the page size from the standard page size according
  173. to the print mode.
  174.  
  175.    AUTO  COLUMN - determine optimal number of columns for selected input file.
  176. This  function  will  scan  the  file  and  will choose such minimal number of
  177. columns,  which  will produce minimal number of pages.  This value can be very
  178. suspicious  (can  you  imagine your assembler source in 13 columns?  but these
  179. can be really optimal if you take care only of the number of pages) and can be
  180. limited by the "SEARCH LIMIT" switch.
  181.  
  182.  
  183. 6. String gadgets
  184. -----------------
  185.  
  186.    Page width - width of the current page in the current mode (in characters).
  187.    Page height - height of the current page in the current mode (in lines).
  188.      - these two values are usually not entered by the user, because it's
  189.        better to select the standard page dimensions and use the STD SIZE
  190.        command.
  191.  
  192.    Tab size - size of the tab (in characters).
  193.  
  194.    Column width - width of the column.
  195.    Number of columns - number of columns across the page.
  196.      - you can enter one of these values (will be marked by the "«" sign) and
  197.        Columns will calculate the correct value of the other parameter.
  198.  
  199.    Std page X & Y - dimensions of the page in standard font (with all the font
  200.      switches switched off). This page is used as the base for the STD SIZE
  201.      command.
  202.  
  203.    Number of the 1st page - this value will be used as the number of the first
  204.      page (for example: you can start the page numbers with 7 if you have six
  205.      pages to use them as first six).
  206.  
  207.    Page header - this string will be used as the header of each page if you
  208.      turn the HEAD switch on. The percent sign ("%") followed by one character
  209.      will be replaced by some special string:
  210.  
  211.            %s - partial file name (without full path)
  212.            %f - full file name
  213.            %p - page number
  214.            %d - current date
  215.            %t - current time
  216.  
  217.      The header will be centered automatically.
  218.  
  219.  
  220. 7. Option gadgets
  221. -----------------
  222.  
  223.    Control characters - selects which set of control characters you wish to use
  224.  
  225.          EPSON - use control characters for EPSON printers. In this mode, the
  226.                  PRINT command will not use the standard ANSI output via the
  227.                  printer.device, but the direct output via the parallel
  228.      or serial.device.
  229.  
  230.           ANSI - use standard ANSI control sequences usable for all printers.
  231.                  In this mode, the printer output will be done via the
  232.                  printer.device, but it doesn't support the SMALL mode.
  233.  
  234.           NONE - don't emit any control characters.
  235.  
  236.    Extraneous characters - selects what you wish to make with these
  237.      characters, which exceed the column margin
  238.  
  239.            CUT - remove them.
  240.  
  241.          RIGHT - place them on the right side of the next line (default).
  242.  
  243.           LEFT - place them on the left side of the next line.
  244.  
  245.    Print mode - specifies the font type
  246.  
  247.          ELITE and EPSON specify the width of the characters:
  248.  
  249.                                   ELITE     CONDENSED     CPI (chars per inch)
  250.  
  251.                  Epson printers   OFF       OFF           10
  252.                                   ON        OFF           12
  253.                                   OFF       ON            17
  254.                                   ON        ON            20
  255.  
  256.             some other printers   OFF       OFF           10
  257.                                   ON        OFF           12
  258.                                   OFF       ON            15
  259.                                   ON        ON            18
  260.  
  261.          SMALL - when used (doesn't work in the ANSI mode), the printer will
  262.                  double the number of lines of the page (allows 180 lines on
  263.                  the DIN A4 page).
  264.  
  265.    Quality - specifies the print quality - usually used when you have an old
  266.              ribbon in the printer.
  267.  
  268.            NLQ - use the Near Letter Quality mode.
  269.  
  270.           BOLD - print bold letters.
  271.  
  272.    Page formatting - defines format of the page
  273.  
  274.             FF - put form feeds after pages (if off, only line feeds are
  275.                  emitted).
  276.  
  277.           HEAD - use page header.
  278.  
  279.          LINES - separate the columns by vertical lines ('|').
  280.  
  281.          EPSON - use standard Epson dimensions of the font (see font switches).
  282.  
  283.           LNUM - generate line numbers before each line. The AUTO COLUMN
  284.                  function doesn't give reliable results in this mode.
  285.  
  286.    Character conversion - chooses the Character conversion mode. In this mode,
  287.       each character can converted to any other character using the conversion
  288.       table (see the file name boxes). Characters converted to 0x00 will be
  289.       ignored (use for example if you want to remove form feeds from your
  290.       document). The conversion tables can be simply edited by the CTED
  291.       program.
  292.  
  293.    Large buffer - forces Columns to load the whole file before processing it.
  294.       Normally, the file is read by the four-kilobyte parts. This options
  295.       speeds up loading from the disk, but uses more memory.
  296.  
  297.    Search limit - sets and enables the maximal number of columns for the AUTO
  298.       COLUMN function. Protects you against unusable (but really optimal)
  299.       results.
  300.  
  301.  
  302. 8. Final words
  303. --------------
  304.  
  305.    Send your comments, suggestions and bug reports to mjsoft@k332.feld.cvut.cz.
  306.  
  307.